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If You've Never Used a 
'Machine Language Monitor' 
Belore 

The following section ts intended tor 
people who are unfamiliar with the 
uses of a machine language (M.L.) 
monitor program* However. It Is not a 
tutorial in the architecture of the C64 
or the 6502. Nor is II Intended to teach 
6502 assembly language program* 
ming. In (act, some knowledge ot 
assembler language will bo most 
helpful. It IS intended to help the 
beginner gel started in using 
HESMON. Even those who Know 
nothing about the 6502 or the C64 will 
find some ot HESMON's commands 
uselul (see, tor example, the Interpret 
Memory command). 

It you are lamlliar with the C64's 
screen editor, you should have no 
trouble entenng and editing HESMON 
commands. HESMON commands are 
entered and edited just as are BASIC 
direct mode commands They consist 
ot a single character usually followed 
by one or more 'parameters* and a 
RETURN. The parameters consist o' 
hexadecimal numbers or character 
strings and are separated from one 
another by spaces. With one excep- 
tlon (the *#* command) numeric 
parameters must be hexadecimal and 
do not need to be prefixed with '5' 
String parameters are identified by 
enclosing them in double quotes f ] II 
HESMON doesn't understand a com* 
mand it will print '?*, usually just to 
the right of the bad command. It the 
command is understood, but the 
result is Impossible or illegal, eg., try- 
inglosave HESMON it sell on tape, 
HESMON pnnts a '?' on the following 
line. 



To use HESMON, turn your C64 off. 
insert the HESMON cartridge into the 
expansion slot in the C64 and then 
turn the power on. You will see the 
HESMON version number, the pro- 
grammer's name, the H.E.S, copynght 
message, and the cold start" register 
display: 

C* 
PC IRQ SR AC XR YR SP 
iOOOO EA31 27 00 00 00 FA 

The meaning of this rather cryptic 
display is as follows: The first line *C* f 
identifies a cold start of HESMON, 
that is, starling up from power-on. The 
next line Identifies the pseudo 6502 
registers maintained by HESMON: 

PC = program counter 
IRQ =■ interrupt request vector 
SR - status register 
AC = accumulator 
XR = X register 
YR = Y register 
SP = stack pointer 



NOTE: '6502" is used synonomously 
tor "6510" in this document. 

The register contents are shown on 
the thin) line. The quantities shown in 
the register display (except the IRQ) 
are not the actual register contents, 
they are the numbers HESMON will 
use to set the 6502 registers when in- 
structed to begin execution ot a M.L. 
program. IRQ is not a 6502 register, 
but a RAM vector' that points to an 
IRQ interrupt service routine. Begin- 
ners may Ignore this location — but 
better not change it! The *;' at the 



beginning of the tast line Is really a 
HESMON command. It tells HESMON 
(i( the RETURN key is pressed with 
the cursor on this line) to put the 
seven numbers that follow into the 
corresponding pseudo registers. Just 
before beginning execution of a ml. 
program HESMON copies the pseudo 
register contents to the 6502 
registers. So. (or example, if we want 
the C64 to print Hl/ t we could first 
move the cursor up to the 7 line and 
alter it to read: 

1200 EA31 27 48 49 2E FA 

When we press RETURN, the 6502 
pseudo program counter is set to 
S 1200; while the accumulator, and X 
and Y pseudo registers are set to $48 
(ASCII H). 549 (ASCII I), and S2E 
(ASCII). Now, if we write a program at 
$1200 to print the AC, XR, and YRit 
will print 'HI- when we execute the 
HESMON Go command. Let's write 
such a program using the HESMON 
Simple Assembler command, 4 A\ Type 
in the following lines: 

A1200 JSR FF02 

TXA 

JSR FFD2 

TYA 

JSR FFD2 

BRK 

The A' beginning the first line tells 
H ESMON we wish to assemble, that 
is, translate assembly mnemonics In* 
to machine code As you press 
RETURN alter typing each ot the 
above lines, you w«t see HESMON 
reprint the line, showing the machine 
code generated from the assembly 
language Instruction. HESMON will 
then prompt for the next line ot pro- 
gram by printing the 'A' command and 
the next available address followed by 



a space. So you don't have to Keep 
track of what the next address is, just 
type in the assembly language in* 
structions. When you've finished the 
program, |ust press RETURN and 
HESMON will exit this mode. By the 
way, SFF02 is on© ot the l Kemar 
routines in the C64's ROMs. It prints 
the contents of the accumulator to 
the current output file — the screen In 
this case. For further information on- 
this and other useful ROM routines, 
consult the Commodore 64 Program 
mere' Reference Guide'' published by 
Commodore 

Now type G and hit RETURN. You 
should see: 

G 
HI 

B* 
PC IRQ SR AC XR YR SP 
;120C EA31 30 2E 49 2E FA 

Notice after the 'HI.' is another 
register display, the break entry 
display identified by 'B". This means 
we've reentered HESMON by ex- 
ecuting a BRK Instruction — the one 
at the end of our short program. Now 
examine the register contents. The PC 
points one address higher than the 
BRK instruction. The X and Y 
registers and stack pointer are un- 
changed. The accumulator now has 
the S2E transferred Into it by the TYA 
instruction at $1207, Let's play with 
this a bit. Type 'D1200 120BV This 
command instructs HESMON to 
'disassemble' the program you |ust 
entered. 

Now, move the cursor to the last line, 
at address S120B, and type the follow- 
ing, with the "A* replacing the V (also 



bo sure io blank out any characters 
left on the screen after the '&): 

A 1208 LDA «48 
JMP 1200 

We now have a M.L. program that will 
print 'HI/ forever — or until we stop It, 
Type 'G1200*. When you tire of watch- 
ing me stream of *Hl.HI.HI/s, press — 
no> not the STOP key - the 
PESTORE key by itself. The RESTORE 
key is HESMON's super-STOPkey. It 
will halt just about any MX* program 
(except HESMON itself) when 
HESMON is plugged In (Exception: If 
you attempt to use RS232 files all 
bets are off. Also, correct operation of 
RS232 files is not guaranteed with 
HESMON Installed.) To get back to 
our example: after pressing RESTORE 
you should see a clear screen with the 
following: 

S" 

PC IRQ SR AC XR YR SP 
;XXXXEA31 XX XX XX XX XX 

This Is the RESTORE entry display, 
identified by the *S"\ The X*s are not 
actually what you will see. The 
register contents will depend upon ex- 
act ly when you pressed RESTORE 

If you want to enter a series of bytes 
into memory, use the Memory Modify 
command (:) For example, to enter 
the sequence $01 , S02, $03. $04, $05, 
$06, $07 . . . starting at $1234, you 
type: 

:1234 01 0203 04 05060708 

HESMON will respond by reprinting 
the line and will prompt for another 
line by printing the next available ad- 
dress. As with the Assemble com- 
mand, you may exit by typing 
RETURN. 



Besides entering programs and data 
Into memory, one of the functions of a 
ML monitor Is to examine programs 
and data already in memory HESMON 
has several commands tor this pur- 
pose; including Disassembly (0), 
Memory Display (M), and Interpret 
Memory (I). These three commands 
are special in that the cursor up and 
cursor-down key may be used to 
'scroll' their displays forward and 
backward through memory. The ac- 
tion of this scrolling is easier to use 
than to describe. Think of the text on 
the screen as being on a drum which 
may be rolled up or down using the 
cursor up/down key. The scrollable 
display type found closest to the edge 
of the screen where new lines will ap- 
pear is continued In the scroti direc* 
lion. I said it was hard to describe! Try 
It Just type DAAD7' and hit RETURN. 
Then press and hold the cursor-down 
key. To scroll up. go to the top of the 
screen and then hold down the 
cursor*up key, 

Other commands allow you to hunt 
for a particular sequence of bytes in 
memory {H) t compare t wo blocks of 
memory for differences (C), or transfer 
a block of memory to a different loca- 
tion (T). There are also two advanced 
functions: N— relocate absolute 
memory relerences In a program, and 
E— change the external references in 
a program. Finally, there are number 
base conversion and hexadecimal 
arithmetic functions. 



Alphabetical List and 

Description of HESMON 
Commands 

The following section lists the 
HESMON commands in alphabetical 
order describing each in detail and 
giving example<s) of Its usage. 

A — The Simple Assembler 

The HESMON simple assembler pro- 
vides an easy way to enter short M.L 
programs. It does not have all the 
features found in a complete 
assembler such as HESBAL in HES's 
6502 Professional Development 
System for the VIC and Commodore 
64, but It provides increased conve- 
nience compared to POKEing from 
BASIC or entering hexadecimal codes 
using a more primitive monitor The 
syntax ot HESMON's Assembler com- 
mand Is as follows; 

A1111MMMOOOOO 

where 1 11 V is a 'our digit hex- 
adecimal address in the C84*s RAM t 
MMM' is a standard three character 
assembler mnemonic for a M.L opera- 
tion code {op<ode) t such as JSR. 
LDA, etc. OOOOO" Is the 'operand* of 
the op-code. It is beyond our scope 
here to discuss fully the meaning of 
those parameters — for a complete 
discussion, consult a book on 6502 
assembly language programming. See 
Section I for a simple example of A's 
usage. Notice that since all numeric 
operands MUST be in hexadecimal 
notation the customary T preceding 
these numbers Is optional; as Is the 7 
preceding 'X' or "Y* in indexed instruc- 
tion operands. If HESMON 
understands the line, it will reprint it 
showing the corresponding byte(s) of 



M.L between the address and the 
assembly code. HESMON will then 
prompt for the next line ot assembly 
code by displaying the next address 
followed by a space and the Input cur- 
sor If HESMON cannot interpret the 
tine, it will print a *?' Instead of 
prompting for the next line. For exam- 
ple, you type: 

A 1200 LDA M1 

HESMON responds by overprinting 
your tine and then prompting for the 
next line as follows; 



A1200A941 
A 1202 



LDA #$41 



Note — HESMON ignores anything to 
the right of a ':' on the line. 

B — Breakpoint Set 

There are three different methods to 
return to HESMON from a M.L. pro- 
gram. The Breakpoint Set command is 
one of them. This command allows 
you to designate an address in a pro- 
gram as a 'breakpoint/ that is, a place 
where the program Is to be halted and 
control is to be returned to HESMON. 
Breakpoint Set also allows you to 
specify the number of times the in* 
struction at this address is to be ex- 
ecuted before the breakpoint is ac* 
tivated. The breakpoint defined with 
Breakpoint Set is effective ONLY 
when the C64 is executing HESMON's 
Quick Trace command. For example, 
to halt a program, that starts at ad- 
dress S12O0, on the fifth repetition of 
the instruction at address $1234, you 
would type: 

B 1234 0005 
Q1200 



The I*rst line above sets the break- 
point at $1234 and the repeat count to 
live- The second line initiates the 
Quick Trace mode of program execu- 
tion (see the Quick Trace command* 
When address $1234 has been 
reached for the titth time HESMON 
will hall execution of the program, 
display the current values of the 6502 
registers, and enter the single-step 
mode of execution (see the Walk com- 
mand). 

The second method to return to 
HESMON from a ML. program is to 
insert a 6502 BRK* Instruction into 
the program. ObviousJy. since this 
method requires program modifica- 
tion, it may be used only with pro- 
grams in RAM. Finally, HESMON may 
be called by simply pressing the 
RESTORE key. In either of these last 
two cases HESMON will be re-entered 
whether or not the Quick Trace mode 
was active. If a 8RK instruction was 
encountered, the 'break" entry register 
display will be printed showing the 
contents of the 6502 registers. 
Similarly, if the RESTORE key Is 
pressed, the RESTORE entry regteter 
display is shown. In the latter case, 
the screen is cleared first. The 
RESTORE key method of HESMON re- 
entry will work any time the HESMON 
carlndge is plugged in — unless an 
RS232 file has been accessed or the 
6502 has attempted to execute an 
undefined op-code (one that 
disassembles as 4 777\ Alter an 
RS232 file has been attempted 
HESMON may be re-entered from 
BASIC via a BRK instruction. Type 
'SYS8' to cause a break entry, 



C — Compare Memory Blocks 

This command compares two sec- 
tions of memory and reports any dif- 
ferences by printing the address of 
one member of the mismatched 
pair(5). The syntax is as follows: 

C111122223333 

where 1 1 1 1 is the start address of the 
first section, 2222 is the end address 
of the first section, and 3333 is the 
start address of the second section — 
t he one to be compared with the first 
section. This command may be 
stopped (In case a large number ol ad- 
dresses are printed) with the STOP 
key. For example, suppose you have 
two disk files containing (you thought) 
the same M.L program residing at 
locations $1400 to S147F. However, 
when you used the BASIC command 
VERIFY, it said VERIFY ERROR'. 
Naturally, you wonder just where the 
difference is. VERIFY can only tell you 
they differ SOMEWHERE. Compare 
Memory Blocks may be used to find 
out: First use HESMON's Load com* 
mand to load one ol the files (See 
Load)* Then move that program to 
Si 500 using the HESMON Transfer 
Memory Block command: T 1400 
147F 1500. Next Load the other file. 
Now compare the two files using 
Compare Memory Block: 

C 1400 147F 1500 

HESMON will print a list of all the 
memory locations which differ be- 
tween the two programs. 

O — Disassemble Memory 

This command is the inverse of the 
Assemble command. It interprets 
memory contents as MX. instructions 
and displays the assembly language 
equivalent Disassemble is used in 



two distinct ways. First It may be 
used to disassemble a section of 
memory by specifying an address 
range, ouch as- 

D 1111 2222 

where 1111 is the start address and 
2222 Is the end. This type ol 
disassembly Is convenient when used 
In conjunction with HESMON's Out- 
put Divert command to produce a 
hardcopy listing ol a Ml. program- 
Second, the disassemble command 
may be started by entering a single 
parameter, the beginning address: 

D1111 

This mode is handy torexamining a 
ml program on the screen because, 
once the first line Is displayed, 
preceding or subsequent lines ot 
code may be disassembled by press- 
ing the cursor-up or cursor-down key 
respectively. 

You may alter a program in RAM using 
the Disassemble command's output. 
If you move the cursor to the line you 
wish to alter, change the byte display 
(not the mnemonic), and press return; 
HESMON will alter the memory con- 
tents and retype the line showing the 
altered bytes and the corresponding 
disassembly. Then HESMON will 
prompt for the next line by printing 
the next address and leaving the input 
cursor on the same line. To exit this 
mode type RETURN, just as with the 
Simple Assembler command. 

E — External Relinker 

This command is rather difficult to 
understand, but the effort Is worth It) 
Basically, this command facilitates 
the transport of Mi. programs from 
one 6502-based computer to another 



(PET, VIC, etc.) by translating the 
system calls of one computer to 
those of another 01 course the 
capabilities of these computers are 
different so one cannot always 
achieve a perfect translation, but at 
least a functioning version can be 
made without completely rewriting 
the program. The heart of this com- 
mand is a table of corresponding ad- 
dresses. This table contains four-byte 
entries consisting of pairs of ad- 
dresses. These address pairs are the 
addresses in the respective computer 
operating systems that perform a 
given task. Typically these will be ad- 
dresses in the ROM firmware of the 
computers. The correspondence table 
must be supplied by you. Usts o' 
common ROM routine addresses in 
various 6502 computers have ap- 
peared in several places, most notably 
in COMPUTE! magazine (e.g.. "Vic 
Memory Map Above Page Zero". COM* 
PUTE! Vol. 4, No. 1,P. 181); "Butter- 
Held on Commodore". Commodore 
Magazine, OctJNov,, 1982, pp- 81 ff.; 
and, lor the PET. in "PEfiCBM Per- 
sonal Computer Guide" by Osborne 
and Donahue* 

For example, suppose you have load- 
ed into your C64 a M.L program in- 
tended to run in a PET with BASIC 4.0 
ROMs. Wo will assume it is in loca- 
tions Si 200 to S13FF. Many ot its ex- 
ternal subroutine caJls are probably of 
the form JSR SFFxx The subroutines 
at these addresses are all almost Iden- 
tical in function to those ol the same 
address in the C64 because these en- 
try points are in a 'jump table 1 set up 
for the purpose of standardizing 
system calls between the different 
Commodore ROM sets. So what's the 



problem? Any subroutine call In the 
address range SBOOO to SFFOO pro- 
bably also has an equivalent In the 
VIC. but It's at a different address! 
This is where External Relmker comes 
in. External Relmker will find such 
subroutine calls and replace them 
with the corresponding C64 ROM 
routine calls — it we can Identify the 
correct replacement (this is where Ihe 
published ROM maps come in). II we 
already have a correspondence table 
constructed In an earlier session with 
External Rellnker, we simply load it 
using the Load command. But. if we 
don't have a table, External Retmker 
wlil use our answers to its queries to 
construct one we may save for future 
use. For the present example, sup- 
pose we have no table, just two ROM 
maps. We want to construct a table 
starting at $1000, so we start it by 
entering four zeroes (four zeroes 
denote the last entry in the table) 
using the Flit Memory Block com- 
mand. 

F10001003 00 

Then we start External Rellnker: 

E 1200 13FF 1000 B000 FF00 

The llrst two parameters tell External 
Rellnker where the start and end of 
the program we are working on are. 
The third says where the cor- 
respondence table starts. The last two 
give the address range we're in- 
terested in relinking. At this point Ex* 
temal Rellnker will start disas- 
sembling our program from $1200 to 
$13FF, looking for references to ad- 
dresses in the specified range of 
SBOOO to SFF00 When it finds such 
an addross It will first consult the cor- 
respondence table which starts at 
$1000 — if no entry for the address Is 



found, it will show the disassembled 
line containing the unknown address 
and wait for the entry of the cor- 
respondence address. We will look up 
the PET address in the published 
table, find its equivalent In the C64 
table, typo the VIC address over the 
one on the screen, and press 
RETURN. HESMON will add the new 
correspondence to its table, alter the 
address reference In the program and 
then continue its search. On subse- 
quent occurrences of this address 
HESMON will automatically make the 
specified replacement. 

F — Fill Memory Block 

This command is used to set a sec- 
tion of memory to a particular value. 
The syntax Is as follows: 

F11112222 33 

where 1111 and 2222 are the first and 
last addresses (inclusive) of the sec- 
tion to be filled and 33 is the hex- 
adecimal quantity to be written. See, 
for example, the usage in the example 
of External Relinked 

G — Go {execute program) 

This command transfers control ol 
the C64 to a M.L program; that is, It 
starts execution of the M.L. program. 
It may be used with or without an ad- 
dress parameter, tf no address 
parameter Is given, execution is 
begun at the addross shown in the 
program counter (PC) of the Register 
Display command. For example you 
may exit HESMON and 'warm start 1 
BASIC by typing; 

GA474 

The C64 will respond. "READY". For 
another example, see Section 1 ■ 
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H — Hunt (or a Sequence 

This command locates a specific se- 
quence o! byles In memory. It has two 
forms, as follow: 

H1111 2222334455.... 

H11112222 I, ABCDE...." 

where 1 11 1, 2222 are the (irst and last 
addresses of the range of memory to 
be searched and 33, 44. etc.. are the 
hexadecimal byte(s) to be found, 
separated by spaces. The second 
form allows the bytes to be specified 
as characters enclosed by quotes. For 
example to find all subroutine calls to 
the character output routine (AB47) in 
the C64 ROM's we would type: 

HA000FFFF20 47AB 

HESMON responds with a list of all 
such subroutine calls. Note thai* as 
usual, the low and then high order 
bytes ol the address were specified 

To find all occurrences of (he string 
"READY 1 {there is only one, at SA378), 
we would type: 

HAQQOFFFF "READY" 



I — Interpret Memory 

This command displays the contents 
ol memory as 'ASCII* characters. It Is 
similar to the Memory Display com* 
mand except that It shows 32 
characters per line. It may be used 
with either one or two parameters and 
its output may be scrolled |usl as with 
the Disassemble command* For exam- 
pie, to see the table of BASIC'S 
keywords and error messages, type: 

IAOQQA3Q0 



L — Load 'Program 1 

This command loads* (Le. v reads) a 
'program* into memory from an exter- 
nal device such as tape or disk. The 
loaded material need not actually be a 
program. For example, it may be a 
section of memory containing a data 
table for External Relinker that was 
saved to tape or disk using the Save 
command. However, the most com* 
mon use of Load is to retrieve M.L 
programs from tape or disk. Note that 
HESMON's Load should NOT normal* 
ly be used to load a BASIC program, 
Tho syntax of Load is as follows: 

L"programname M 11 

where 'programname 4 is the name of 
the hie to be loaded (be sure to in* 
elude the double quote marks) and 
'II 1 Is the device number from which 
to load. It the device number is omit- 
ted, the tape drive will be assumed; If 
the filename is also omitted, the first 
file found on the tape will be loaded. 
For example: 

L U YAHTZEE"08 

The above loads YAHTZEE from 
device eight, the disk drive. 

M — Memory Display 

This command displays (he contents 
of memory in hexadecimal notation. It 
This command displays the contents 
of memory m hexadecimal notation. II 
is similar to the Disassemble com- 
mand in that It may take either one or 
two addresses as parameters. The 
two-parameter lorm displays from the 
first address to the second; the one- 
parameter form shows eight bytes 
beginning with the address given 
Also like the Disassemble command, 
the output of Memory Display may be 



scrolled up or down with the cursor 
up and cursor-down key. For example: 

M A000 A040 

shows from SAOOO through SA047 in 
hex and In characters, eight bytes per 
line. To see more, press cursor-op or 
-down. 

N — New Locator 

This command is a relative of the Ex* 
temal Rellnker command .It has a dif- 
ferent generaJ purpose, however. New 
Locator is designed to convert ab- 
solute address references In a ML 
program from one memory range to 
another It is typically used following 
a Transfer Memory Block command to 
relocate a program in memory. For ex- 
ample, suppose you have lust moved 
a M.L program from $1200-51280 to 
$1300-51380 using T Any address 
references within the program now 
point $0100 too low. New Locator can 
fix this. Type: 

N 13001380 010012001280 

The meaning of the above line is as 
follows: Disassemble from $1300 to 
S1380 checking for addresses in the 
range $1200 to $1280 Add $0100 to 
any such addresses. If we had moved 
a table of addresses, for example a 
'jump table' (pairs of numbers of ad- 
dresses, low byte followed high byte), 
instead ot actual machine code; we 
would put a 'W* following the last 
parameter to tell New Locator to treat 
the memory contents as pairs of ad- 
dress bytes rather than M.L. The 
general Syntax for New Locator is the 
following; 

N 1111 2222 3333 4444 5555 [W] 

where 1111 and 2222 specify the ac- 



tual memory range to scan r 3333 Is 
the 'offset' to add to adjusted ad- 
dresses, 4444 and 5555 specify the ad- 
dress range of references which are 
to be adjusted, and W (if present) 
specifies that the scanned range Is a 
table of 'words' with no op*codes. If 
not In the 'word table' mode, New 
Locator will haJt and display any line 
of machine code it can't disassemble. 

O — Output Divert 

This command is HESMON's 
equivalent to BASIC'S CMD com- 
mand. It allows HESMON's output to 
be printed on the C64 printer or stored 
in a disk file instead of being 
displayed on the screen. This is the 
preferred method to gel HESMON's 
output on a device other than the 
screen. Output Divert has a number of 
options. The complete syntax of the 
command is: 

011 22 "filename" 

where '1 V is the device address where 
the output is to be sent (normally 04 
for the printer), '22' Is the 'secondary 
address* of the device (typically 02 to 
0E for the disk drive), and 'filename' is 
the filename to be used for storing the 
output (see your disK drive documen- 
tation). All of these parameters are op- 
tional. If you merely type *0' HESMON 
will open a (lie to device 4, the printer, 
and start diverting its output. If you 
type 'O' when the output is already be- 
ing diverted, the file will be closed and 
the output will be directed to the 
screen again. That is, typing *0' 'tog- 
gles' Output Divert on and off. If you 
want explicitly to revert to screen out- 
put, type '03F\ The secondary ad- 
dress and filename default to 'none' 
since they are not needed by the 
printer. For more information about 
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filenames and secondary addresses, 
consult the documentation for the 
device to which you wish to divert 
HESMON's output, 

P — Print Screen 

This command is a limited version of 
Output Divert. It copies the current 
screen display to printer or disk. It's 
Just like having a snapshot ot the cur* 
rent screen image. The parameters of 
Print Screen are the same as for Out- 
put Divert, except there is no toggling 
because Print Screen automatically 
reverts to screen output at the com- 
pletion of the screen copy. Note: Print 
Screen will NOT copy high resolution 
graphics. 

Q — Quick Trace 

This command is used after the 
Breakpoint Set command in de* 
bugging M,L. programs. It takes one 
or zero parameters just like the Go 
command. If specified, the parameter 
gives the address at which to begin 
execution. If omitted, execution 
begins at the PC shown in the register 
display. The difference between Quick 
Trace and Go is that a breakpoint, 
defined with the Breakpoint Set com* 
mand. is only recognized in the Quick 
Trace mode of execution — the break* 
point will be ignored if execution Is 
begun with the Go command. Pro- 
gram execution Is much slower with 
Quick Trace than with Go because 
Quick Trace is really just a fast ver- 
sion of the Walk (single step) com* 
mand. Using Quick Trace, instructions 
are executed one at a time and 
HESMON Is re-entered after each. 
This process continues until the 
defined breakpoint is reached. For an 
example of Quick Trace usage, see 
the Breakpoint Set command. 



H — Register Display 

This command displays HESMON's 
current 6502 pseudo register contents 
as well as the current interrupt re- 
quest (IRQ) RAM vector. The IRQ vec- 
tor is shown as a convenience to the 
programmer who wishes to use this 
vector to run interrupt-dnven or 
'background' routines. This vector 
may be altered like any ot the register 
contents; however, extreme caution 
must be exercised in so doing 
because the replacement is made IM- 
MEDIATELY, not at the time of execu- 
tion of a Go command. Therefore, the 
interrupt handling routine must be in- 
place BEFORE the IRQ vector Is 
altered. 

There are no parameters for the 
Register Display command. |ust type 
■R\ To alter the register contents* 
move the cursor to the line beginning 
with ';' and overwrite the display Then 
hit RETURN and the contents will be 
altered. Note that the display, except 
as noted tor the IRQ vector, shows 
the contents ot the 6502 registers at 
the time HESMON was entered. These 
registers will be set by HESMON to 
the values shown in the register 
display (ust prior to beginning execu 
lion of a program using the Go, Quick 
Trace, or Walk commands. For a fuller 
discussion of the meaning of this 
display, see Section I 

S — Save Program 1 

This command saves the contents of 
a specified range o! memory to an ex* 
ternal device as a non-relocating 'pro- 
gram' file* The non- relocating' part 
means that the program may be 
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reloaded from tape using BASIC'S 
LOAD command. The syntax ol Save 
Is as follows: 

S J f ilenane" 1 1 2222 3333 

where filename' is the filename to be 
used (don't forget the double quote 
marks), *1V is the device number on 
which lo save (01. for the tape and 06 
lor the disk drive), 2222' is the be* 
ginning address. '3333' Is the last ad- 
dress PLUS ONE of the memory area 
to be saved. All the parameters must 
be given, except that in tape saves the 
'filename' may be null ("*'). Forexanv 
pie, to save a M.L program residing 
from S1500 to SlDFF to the disk as 
APROGRAMMype: 

S "A PROGRAM" 08 1500 1 E00 

Again, notice the last parameter is 
one byte higher than the last program 
address. Also, note that HESMON's 
Save should NOT be used to save 
BASIC programs because HESMON 
saves programs as absolute, not 
relocatable, files. 

T — Transfer Memory Block 

This command transfers the contents 
of a block ot memory to another area. 
Us syntax is as follows: 

T1111 2222 3333 

where 1111, 2222 are the first and last 
address (not last-plusone)of the 
block to move and 3333 Is the starting 
address where the block is to be 
moved to. 

U~ (Test Color RAM) 

Uhasnoparameters.lt tests the color 
RAM for proper function and prints 
*OK T if they are working. If there is a 
bad byte, its address will be printed. 
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V — Verity RAM Function 

This command tests a section of RAM 
for proper function* Its syntax is: 

V11112222 

where 1 1 1 1. 2222 are the first and last 
memory locations ol the block to test. 
H ESMON will keep cycling the lest 
over the address range specified until 
lhe STOP key is pressed {it may be 
necessary to hold it down for a 
second or two). At the successful 
completion of each test of the 
memory block, HESMON will print 
to show it is working. If a memory 
location 'alls the test, HESMON will 
print its address followed by a binary 
n umber showing the data incorrectly 
stored. The bits of the number are 
shown most significant (bit 7) to least 
significant (bit 0) left to right. The bits 
of the RAM location that are different 
from the test data are printed in 
reverse field. Using the information 
printed on the screen it will usually be 
possible to pinpoint the bad RAM 
IQsl Note that it you 'test' addresses 
that contain no RAM, a seemingly ran- 
dom pattern of numbers will be 
printed. 

W - Walk Program 

This command causes single-step ex- 
ecution of a ML program under user 
control. It. like Go and Quick Trace, 
may be used without a parameter to 
begin at the register display PC loca- 
tion; or It can accept one parameter 
that specifies the starling address. To 
exit the Walk mode, press the STOP 
key. To step as rapidly as the registers 
can be printed, press the SPACE bar. 
To step at the key repeal rate, press a 
normally repeating key. e.g.. the cur- 
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sor down key. To take one step only, 
press a normally non-repealing key, 
e,g. f the left-arrow key. The 'J' key has 
a special function in Walk mode. II 
causes MESMON to continue execu- 
tion at lull speed until a retunvtronv 
subroutine instruction Is executed 
For example, type: 

WAA07 

HESMON will begin execution at 
SAAD7 — the carnage return, linefeed 
output ROM routine. After executing 
the instruction at that address 
HESMON will halt, showing the 
register contents and a disassembly 
ol the next instruction the C64 will ex* 
ecute il Walk is continued. The 
d isplay in the above example is as 
follows: 

25 OD 00 00 FA 

,AAD9 20 47 AB JSR SAB47 

The first ol the two tines above shows 
the 6502 register contents in the same 
order as the Register Display com- 
mand: SR AC XR YR Sft This example 
assumes HESMON has Just been cold 
started, otherwise the registers — ex* 
cept the accumulator — maydllfer 
Irom those shown here The second 
lino shows that the C64 will next do a 
subroutine call to SAB47, the 
character output routine used by 
BASIC. To continue, press any hey ex* 
cept STOP or \T (no need to hit 
RETURN), Suppose we press the left- 
arrow key once. HESMON will now 
show two more lines: 

25 OD 00 OOFS 

,AB47 200CE1JSR$E10C 

Now we see the C64 is at location 
SAB47 about to execute a subroutine 
call to SE 10C Notice the stack pointer 
<SP) has been decremented by two 



because the return address for the 
JSR Instruction was pushed' on the 
stack before the jump lo SAB47 was 
executed. Let's press the left-arrow 
once more; 

25OD00 00F6 

.E1X20D2FFJSRSFFD2 

Here we finally get to a place where 
the C64 Is going to a 'Kemar routine 
we can recognize: the character out- 
put routine SFFD2 Since this routine 
is documented in the C84 literature, 
we know exactly what it will do: pnnt 
the character SOD in the accumulator. 
Therefore, we needn't single step fur- 
ther through that routine. So we press 
the 'J' key. HESMON shows (after a 
blank line— where the carnage return 
was printed): 

200D00 06F6 
.E10FB0E8 BCSJE0F9 

Now the C64 is at the point just 
following the JSR SFFD2 instruction. 
The 'carry' bit (bit 0)ot the status 
register (SR = $20) Is clear (0), so the 
branch on carry set (BCS) will not be 
taken. At this point we may continue 
to single step through this subroutine 
by pressing left-arrow; return to the 
next higher level ot code <SP = SF8) by 
pressing 'J'; or quit the Walk com* 
mand by pressing STOP 

X Exit to BASIC 

T his command gives control to the 
C64's BASIC interpreter It has two 
forms. The first form 'XC has the 
same effect as if the C64 were turned 
off and then back on without the 
HESMON cartridge plugged In except 
that HESMON may be entered by 
pressing RESTORE. The second 'orm 
X causos a 'warm start' ol BASIC. 



13 



similar to pressing RESTORE when 
HESMON is not plugged in. Your first 
exit to BASIC from HESMON alter 
turning on the C64 should be an *XC\ 
otherwise BASIC may misbehave. 
While in BASIC, to achieve the same 
effecl as pressing STOP & RESTORE 
without HESMON: First press 
RESTORE. Then type 9C and hit 
RETURN. 

— Convert Decimal to Hexadecimal 

This command prints the hexadecimal 
equivalent of a decimal number. If the 
decimal number Is negative it shows 
the two's complement l&bit hex 
equivalent and the corresponding 
positive decimal number. For exam* 
pie: 

#1234 

HESMON shows (on the same line;: 

• 1234 =$04021234 

$ — Convert Hexadecimal to Decimal 

This command prints the decimal 
equivalent of a hexadecimal number 
For example: 

SABCD 

H ESMON shows (on the same line): 

SABCD 43981 

+ — Hexadecimal Addition 

This command prints the sum ol two 
hexadecimal numbers in hex and 
decimal. All (our dgrts. including 
leading zeroes rl needed, must be 
used. Example: 

+ 1234 5678 



HESMON shows (beginning on the 
same line): 

+ 1234 5678 = $68AC 26796 



Hexadecimal Subtraction 

This command prints the difference of 
two hexadecimal numbers in hex and 
decimal: 

- 1234 5678 

HESMON shows (beginning on the 
same line); 

- 1234 5678 -SBBBC48060 

Notice that the decimal number in 
this example is positive even though 
we would expect the result of this 
subtraction to bo nogatlvo. This Is 
because the two-byte number SBBBC 
doesn't retain the Information that the 
result Is negative- If you want to know 
the true negative decimal result, 
either type in the operands in the 
reverse order, or type: 

- 0000 BBBC -$4444 17476 

So. the true decimal value of the dif- 
ference $1234 -$5678 is -17476, 
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Things to be careful about 
when using HESMON 

The BASIC interpreter has control of 
the C64 at all times when BASIC IS 
running. This means that the worsl 
that's likely to happen il your BASIC 
program has an error is that BASIC 
will issue a 'SYNTAX ERROR' 
message and stop your program. A 
ML monitor, on the other hand, must 
allow lis user to take complete control 
of the C64 to eaecute certain com* 
mands. So, if your M.L, program has 
an error and you attempt to execute It 
using the Go command, the likely 
result (s that (he C64 will go catatonic 
— that Is, even the RESTORE key may 
not bring back HESMON. In this event 
you will have to tum the power ott and 
back on to get back to HESMON. You 
may avoid this catastrophe by using 
the Walk command to check out your 
program. Nevertheless, you can still 
send the C64 to never-never land by 
attempting to Walk through an In- 
struction that disassembles as *???'. 
These instructions are 
'unimplemented op-codes*. They do 
not have a defined result. Many of 
them cause the 650? to crash* — that 
Is. enter a slate from which it may be 
recovered only by powering on again, 

HESMON uses 33 bytes near the bot- 
tom of the machine stack (S120-S141) 
(or its variable storage. Most M.Lpro* 
grams do not use a sufficiently large 
amount of the stack to interfere with 
this storage — but it is a possibility to 
be aware of. Large, complex BASIC 
programs sometimes do use enough 
of the stack to interfere with these 
locations. And finally. RS 232 files will 
not work correctly when HESMON is 
plugged In. 



Acknowledgements 

The seeds ol HESMON are contained 
in the public domain monitor pro- 
grams tor thft PET /CBM computers 
known as MICROMON and EX- 
TRAMON. These programs, while not 
directly useful in the C64 environ* 
menl. provided at least the general 
framework and the philosophy of 
user-friendliness which distinguish 
them and HESMON from other ML 
monitors ol the author's experience 

VIC, PET. C64 and CBM are 
trademark ol Commodore. 



15 



Appendix A 

The HESMON Commands 
in Brief 

The following is a condensed list of 
HESMON s commands forquick 
reference Brackets ([]) denote optional 
parameters. 

A 1111 MMM OOOOOO - Simple Assembler 

B 1111 2222 — Breakpoint Set 

C 1 1 1 1 2222 3333 — Compare Memory Block 

D 1 1 1 1 [2222] — Disassemble 

E 1 1 1 1 2222 3333 4444 5555 (W) — External Relinker 

F 1111 2222 33 — Fill Memory Block 

G [1111) -Go 

H11112222 33 44 55....or 

1111 2222"XXXXX "— Hunt tor sequence 

11111 (2222) — Interpret Memory 

L "name" 1 1 — Load Program 

M1111 [2222] — Memory Display 

N 1111 2222 3333 4444 5555 [W]— New Locator 

O (1 1 [22 ["name"]Il — Output Divert 

P [1 1 (22 ["name"iD — Print Screen 

Q[1111] — Ouicktrace 

R — Register Display 

S "name" 1 1 2222 3333 — Save Program 

T 1111 2222 3333 -Transfer Memory Block 

U- Test Color RAM 

V 1111 2222- Verify RAM 

W[1111J — Walk 

X[C] — Exit to BASIC 

R 11111 — Decimal to Hex 

S 1111 — Hex to Decimal 

+ 1111 2222 — Hex Addition 

- 1111 2222 — Hex Subtraction 

: 1 1 1 1 22 33 44 55 66 77 88 — Memory Modify 

; 1 1 1 1 2222 33 44 55 66 77 - Register Modify 

, 1 1 1 1 1 1 [22 [33U XXXX — Disassembly Modify 
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